Cream of the Crop 20/Cream of the Crop 20 (Terry Blount) (1996).iso/windows/smehtm10.zip/SMEHTM.HLP

OS/2 Help File | 1996-06-23 | 33KB | 721 lines

ΓòÉΓòÉΓòÉ 1. Smalled HTML Extensions ΓòÉΓòÉΓòÉ

                                   SMEHTM 1.00

The Smalled HTML Extensions are written as extensions for the Smalled editor.
However, SMEHTM can be used with any other MLE based editor, such as the OS/2
system editor or Zed. The Extensions act as a floating toolbar in the form of a
notebook. Also included in this package is an HTML example page that shows some
useful samples of HTML tags.

o Disclaimer Registering/Shareware
o Using SMEHTM
o The Pages
o What's New/History
o Future Attractions
o About the Author
o Smalled
o Thanks


ΓòÉΓòÉΓòÉ 1.1. Using the Smalled HTML Extensions ΓòÉΓòÉΓòÉ

 When you start using SMEHTM, the first thing you should do is give the main
window the dimensions and place you prefer on the screen. These will be
remembered. (The SMEHTM controls may have different sizes for different screen
resolutions.)

The next thing to do is to decide which editor you will use. SMEHTM was built
with Smalled in mind, but it will function with any MLE based editor, such as
the system editor (E.EXE). The first time SMEHTM is started, it will
automatically start the system editor. It's fairly certain that everyone has
this editor. If another editor is preferred, use the Config page to tell the
Smalled HTML Extensions to use that editor. (SMEHTM can be started from within
Smalled v1.4 or higher. In that case this setting doesn't have any meaning.)

Every time a button in SMEHTM is pressed a tag will be entered in the editor,
and the focus is then returned to the editor. All the HTML tags supported by
SMEHTM are explained in the sections about the SMEHTM pages.

Most of the time an HTML tag consists of two pieces, between which is text that
will  be formatted. For example, <H1>formatted text</H1>. You can press the
Heading 1 key on the SMEHTM Font page and these tags will be entered in the
text as <H1></H1> with the cursor between them. You can then start typing right
away. This method is mostly used for writing an HTML page from scratch.
Another method for entering HTML tags is to select the text you want to format
and then hit the appropriate button in SMEHTM. The tags will be placed around
the selected text and the selected text will stay intact. This method is used
when adding tags to already existing text.

The exception to this rule is the Char page which can be used to add accents to
letters. If this is desired, you must select exactly one letter and hit the
accent button of choice. If more than one character is selected or nothing is
selected, nothing will happen.

Many of the pages in SMEHTM contain controls other than buttons. These controls
are always grouped together with at least one button. If these controls (most
of them are spinbuttons) don't contain a value or show the value 0, nothing
will be inserted in their place in the tag. Many tags can have different forms.
The <HR> tag, for example, has many possible combinations. Here are some of
them:

Example

<HR>
<HR NOSHADE>
<HR WIDTH=66% NOSHADE>
<HR ALIGN=right SIZE=4 WIDTH=66 NOSHADE>
 By using the extra controls described above, any of these combinations can be
made very quickly.

SMEHTM supports fast keys to access the several pages and controls. This is
described in the section Moving around. Most things should be pretty intuitive,
but it wouldn't hurt to read this section.


ΓòÉΓòÉΓòÉ 1.1.1. Moving Around ΓòÉΓòÉΓòÉ

 All the controls in SMEHTM support shortcuts. Take a look at the buttons and
tags and you will see some of the letters are underlined. This means these
controls can be activated with the push of just one button. You can jump from
page to page by typing just the first letter of the tag. The same goes for the
buttons. They can be accessed with the ALT key in combination with the
underlined letter on the button.

There is one snag though. These keys only act on the active window. With a
notebook there are always two possibilities.

o The notebook window is active. If this is the case, an emphasis rectangle is
  drawn in the current active tab and you can move to other pages just by
  pressing the first letter of the tab or by using the left/right arrows. If
  this window isn't active (emphasis rectangle isn't showing), just click on
  the status line to activate it. The status line is the area next to the two
  arrow pushbuttons.
o The dialog in one of the notebook pages is active. You can tell if this is
  the case by looking at the controls in the dialog. One of these controls
  should have the focus. Another way of detecting this is to look at the
  notebook control. When this doesn't have the focus, the dialog probably will.
  (Of course the frame needs to be selected.)  When this is the case, buttons
  can be activated with the ALT-letter combination. If this is done, the
  function associated with the button will be executed.

Another way of moving between controls is the tab key. If this key is pressed,
the next control will be made active. Pressing Return will activate the current
control.


ΓòÉΓòÉΓòÉ 1.2. The Smalled HTML Extensions Pages ΓòÉΓòÉΓòÉ

 All controls in SMEHTM are ordered in a notebook. Every page in this notebook
handles a different aspect of the HTML tagging language. (This means the number
of pages will certainly grow in the future.)  In the help description of each
page, a short explanation of the HTML code which is handled by that page
appears. Also in the SMEHTM package is an example HTML page which contains a
number of samples.

o Main
o Font
o Page
o Char
o List
o Link
o Table
o Image
o Templates
o Tools
o Config
o Register


ΓòÉΓòÉΓòÉ 1.2.1. Page 1 (Main) ΓòÉΓòÉΓòÉ

 The Main page is used to set up the mandatory items for a basic HTML document.
By pressing the Basic button on this page, the mandatory HTML tags are added to
the text editor window. It doesn't matter how much text already exists in the
editor, this command will add the necessary codes at the top and bottom of the
text.

If the two entry fields on the Main page are not filled, the Smalled HTML
Extensions will add the mandatory codes in their simplest form. In this case,
the following will be added:

Basic code

<!DOCTYPE HTML "-//IETF//DTD HTML//EN">
<!--Smalled HTML Extensions-->
<HTML>
<HEAD><TITLE></TITLE></HEAD>
<BODY>
</BODY>
</HTML>
The first two lines in this sample are Comment lines. They are added to
identify the document. Some browsers like to see the first line. The second
line is added to show that the document was created with the Smalled HTML
Extensions.
The next statement is the first real HTML statement, <HTML>. The <HTML> tag
defines that the document is an HTML page. Note that the document is closed at
the end with </HTML>, nothing beyond </HTML> will show up in your document.

The <HEAD> element contains information about the document. The <HEAD></HEAD>
combination must be between the <HTML> and the <BODY> tags. In most cases it
will only contain the <TITLE> tag.
With the <TITLE> tag, a line can be entered that describes the document. This
title will appear in the titlebar of the browser you're using when viewing an
HTML document. This text can be entered in the Title text field on the Main
page. SMEHTM will automatically enter this text between the <TITLE> and
</TITLE> tags.

In most HTML pages, a background image is used. To accomplish this, the <BODY>
tag has to be modified. This tag uses a BACKGROUND= statement to accomplish
this. Behind this statement the name of an image file (GIF, JPG...) must be
entered between quotes. If the name of an image file is entered in the
Background image field, SMEHTM will change the <BODY> statement appropriately
when the basic code is entered.


ΓòÉΓòÉΓòÉ 1.2.2. Page 2 (Font) ΓòÉΓòÉΓòÉ

 An HTML document doesn't have the capability to handle text that a word
processor has. It can only display one font at a time, but it can do a lot with
that one font. In